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1. About this guide 


Objectives and target audience 

This guide describes how to install and configure the Skrill Prestashop module on both Prestashop 1.6 
and Prestashop 1.7. It assumes that you have an existing Prestashop installation. If there is no distinction 
between Prestashop 1.6 and Prestashop 1.7 it should be considered that there is no difference in the 
relevant set up. 


Conventions used in this guide 
The table below lists some of the conventions used in this guide. 


Table 1-1: List of conventions 


Code example Used to illustrate example code, functions and commands. 
File path Used to indicate a file path or folder structure. 


Menu1 > Menu option2 > Indicates a menu path. 





Skrill Prestashop Module Configuration Guide 1.0 


2. Introduction 


What is the Prestashop module? 


Prestashop is an eCommerce platform, which provides online merchants with a flexible shopping cart 
system, as well as control over the look-and-feel, content and functionality of their online store. 


Prestashop has been fully integrated with Skrill’s online payment solution called Quick Checkout. 
Installing and configuring the Skrill Payment Solution module provides a simple, secure and convenient 
option for connecting to Skrill’s online payment processing platform via Prestashop. 


Skrill customers using Prestashop 1.6 and Prestashop 1.7 have access to a wide range of card and 
alternative payment methods. 


Signing up for a Skrill account 
Before you can start accepting payments through Skrill, you need to open a free merchant account by 
completing the online application form here. 


Once your application has been approved you can configure your Skrill credentials in your Skrill 
merchant account and then copy them in the your Prestashop backend and start taking payments. 
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3. Installing and configuring Prestashop 


Secret Word and API Password 

It is mandatory to setup a secret word and API/MQI password for your Skrill merchant account before 
configuring the Skrill Prestashop module. The secret word is used to authenticate the data sent back 
to your Prestashop server after payment. You must obtain the IP address of your Prestashop server to 
configure the API/MQI password. You can find this IP address by executing the following command 
from a command prompt: 

ping <server domain name> 


For example: 
ping example.prestashopserver.com 
Pinging example.prestashopserver.com [145.76.160.206] with 32 bytes of data: 


Make a note of the set of numbers in the square brackets. This is the IP address. Now you have the IP 
address, you can setup the secret word and API/MQI password as follows: 


Log in to your Skrill merchant account at www.skrill.com 


1 

2. Goto Settings > Developer Settings (Figure 3-1) 

3. Set API / MQI Password using the toggle, type and confirm by clicking Save 

4. For each section, specify the IP address(es) or IP address range of your Prestashop server. 
This prevents payment or money transfer requests from other IP addresses if your secret 
word or API password is compromised. All requests from other IP addresses are denied. 
Access can be granted to: 


e Asingle IP address (e.g. 145.76.160.206 using the example above) 
e Multiple IP addresses, separated by space (e.g. 192.168.0.2 10.0.0.2) 


e A subnet in CIDR notation (e.g. 192.168.0.0/24) 

5. Set Secret Word using the toggle, type and confirm by clicking the Save button 
Note: Your Secret Word must contain at least: 8 characters, 1 uppercase letter, 1 lowercase 
letter, and 1 number. 


Skrill 
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API GUIDES @ 





Home Settings 


GY Home Developer Settings 
Configure API and security settings for your wallet account 
a Transfers 
Bla Bla Wallet 

É Banking ID: 116404455 
@ Balances i Developer Settings : Bla Bla Wallet BE mu ES tte SE m FI ha Itl 5 25 m 
Ss All Transactions Wallet IP Whitelisting API / MQI / GSR / CVT Management API Documentation 
B Users 

[-) Automated Payment Interface (API) Disabled 
B Settings 

Allow requests to the API only from the following IP addresses. 

& Account Settings Your API secure IP addresses: 


LR Developer Settings 
687.120.141.129 


Wallet Label Settings 


© Merchant Information 


[-) Merchant Query Interface (MQI) Disabled 


Allow requests to the MQI only from the following IP addresses. 


Your MQ! secure IP addresses: 


No active secure IP address found 

















E) Gateway Secure Restriction (GSR) Disabled 


Allow gateway sessions to be generated only from the following IP addresses. 


Your GSR secure IP addresses: 


[E] Set API /MQI Password Enabled 


Please provide API/MQI Password in order to enable the service. 


Current Password 
New Password 


Confirm Password 


er 


Set Secret Word Enabled 


Please provide Secret Word in order to enable the service. 


New Password 


Confirm Password 


CD -` 


tings | Privacy Notice | Regulatory Disclosures | Cookie Notice 
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Figure 3-1: Configuring a Secret Word and API/MQI Password 


Download Skrill on your Prestashop backend 


The next stage of the Prestashop integration is to configure the Prestashop module to connect to 


your Skrill account. The steps are as follows: 


Prestashop 1.6 


1. Login to your Prestashop admin account. 


2. Select Modules and Services 
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3. Type Skrill in left side search bar 
4. Click on the green button Install 
5. Once installed select Skrill Settings to configure Skrill (Figure 3-2) 


PRESENTAT 
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ION SKRILL SETTING PAYMENT CONFIGURATION 


) techpubs@skrill.com 


o Url — https://www.skrill.com/fileadmin/content/pdf/acme.png 


Figure 3-2: Skrill Settings with example values in Prestashop 1.6 backend 


Prestashop 1.7 


oF Se YS 


Login to your Prestashop admin account 

Select modules from the left side menu 

Under payment choose module Catalog 

Type Skrill and click install 

Click on Configure to set up your skrill credentials 


Click on Skrill Settings to configure your skrill account (Figure 3-2) 


Configure Skrill Settings 


Configure the Skrill Settings as follows: 


1. 


- 


Enter your Skrill Merchant account ID in the Merchant ID field. This is the Customer ID of your 
merchant account 


Enter your Skrill Merchant account email address 

Enter the API password and Secret word that you set up in the previoussection 

Select a display option for the Skrill Payment Form (Iframe or redirect). See Table 3-1 below 
for a detailed explanation of all Skrill settings 

Either enter a name for your store in the Recipient field to display to customers within the 
Skrill Payment Form 

Optional - Enter a URL of a logo to be displayed on the Skrill Payment Form in place of 
the Recipient text. This URL must be in HTTPS format (begin with https://) 
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Table 3-1: Skrill Settings 


Merchant ID Your unique merchant identifier. This is the 
Customer ID of your merchant account. 


Merchant The email address linked to your Skrill merchant 


Account (email) | account (created by you when you first signed up 
for a Skrill merchant account). 


58010731 


techpubs@skrill.com 








Recipient Optional - A description of your shop. This will 
be displayed on the Skrill Payment Form if you 
do not provide a Logo URL. 

Logo URL Optional - Link to the URL of a logo, to be 
displayed on the Skrill Payment Form. Must be in 
HTTPS format. 


Demo Shop 


https://www.skrill.com/ 
fileadmin/content/pdf/ 
acme.png 


https://myshop.com 





Shop URL URL for the home page of your shop without the 
index.php e.g. if your shop is located at 
https://myshop.com/index.php you would enter 
https://myshop.com 

API Password The API password. This field is mandatory. It 
allows the Prestashop server to receive payment 
information. 

Secret word Enter the secret word configured for your Skrill 
account here. This feature is mandatory and 
ensures the integrity of the data posted back to 
your Prestashopservers. 


Display This setting has two options: IFrame and Redirect 

e IFrame - when IFrame is enabled the Skrill 
Payment Form is embedded in your shop 
website. See Figure 3-3: for anexample. 
Redirect - when redirect is enabled the 
customer is redirected to the Skrill Payment 
Form. This form is displayed on its own in 
the current browser tab. This option is 
recommended if you plan to display 
Payment Methods which redirect the user 
to an external website such as Klarna, 
Rapid Transfer, etc. 
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01. Summary 02. Sign in 03. Address 04. Shipping 05. Payment 





@® English United Kingdom 


16.51 &vR ®© Skrill 


Æ) Skeill APD) ue © 


Card number 


Expiry date Security code 
MM YY CVV 


Cardholder name 
Type the name exactly as it appears on the card 


This payment will be processed as a Skrill Guest payment and 
is subject to the Skrill Privacy Policy. 


PAY NOW 


Cancel 
Powered by 
(Ul Skrill 


Figure 3-3: Iframe (embedded) option 
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4. Displaying Payment Methods 


You can select the payment methods to display to your customer using the Payment Configuration tab. 
The module has a series of payment method sections for each of the payment methods supported by 
Skrill. An example is displayed in Figure 4-1: 


VISA COSO Credit Cards v Enabled YES Show YES 


Separately 


Figure 4-1: Example Payment method section 


For each payment method, specify whether it should be displayed or not (enabled or not Table 4-1) in the 
list of Payment methods displayed in the Prestashop Checkout. Hover over the “?” symbol to the right 
of each payment method to see the countries where it is available. See the Skrill Quick Checkout 
Integration Guide for a full list of countries and an up-to-date list of the countries where each payment 
method is supported. The payment methods are displayed in order of popularity in the customer’s 
country. 


Table 4-1: Payment Method Settings 


Enabled Determines whether this Payment method is displayed - Yes = display, No = 
Do not display. 
Under the Enabled setting is a list of the countries that support this payment 
method. If a Payment method is enabled but the customer’s country is not 


supported (determined by the country set in the billing address the customer 
chose in the Prestashop Checkout) then it will not be shown. 


Show Always set this setting to Yes where available. 
Separately 





Please note that if the payment option is not enabled for your Skrill merchant account, enabling in from 
the backend would not make the payment option visible. You will need to contact 


merchantsupport@paysafe.com in order to discuss activating the specific payment option. 
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All Cards and Alternative Payment Methods 


This special payment option launches the Skrill Payment Form with multiple tabs showing all the 
supported Payment methods available in the customer’s country . The logo for this Payment option in the 
Prestashop Checkout payment information section is as seen in Figure 4-2 below: 


visa SS mt. = | All Cards and Alternative Payment Methods Enabled 
Kiana ë smjssie 


Figure 4-2: Setting up combined Skrill logo 


01. Summary » 02. Sign in 03. Address 04. Shipping 05. Payment 





@ English United Kingdom 


2 / .QQEUR ®© Skrill 


=Æ] Skrill 42/91 nuer 


Ger Skrili 


Figure 4-3: Multiple log 
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5. Customer Experience 


This section describes the customer’s checkout experience when using the Skrill Prestashop module. 


Note: We only describe the Checkout process from the payment selection step onwards as the previous 
steps are unchanged. 


The steps are as follows: 
1. Click a payment method from the list of available payment methods (this list depends on the 
customer’s country, the payment options configured for your Skrill account and the payment 
options configured in the Skrill Prestashop Module 





01. Summary 02. Signin 03. Address 04. Shipping 05. Payment 
Product Description Availability Unit price Qty Total 
a Faded Short Sleeves T-shirt EA 
ea A 16,51€ 1 16,51€ 
f : S Sijs Orange 
Total products (tax incl.) 16,51 € 
Total shipping Free Shipping! 
TOTAL 16,51 € 


VISA SS MIB — 
Karna, 





VISAS 


RAPID. ; 


Figure 5-1: Prestashop Checkout Payment selection showing different payment methods 
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2. Enter Payment details in the Skrill Payment Form. 


01. Summary 02. Sign in 03. Address 04. Shipping 05. Payment 





® English United Kingdom 


16.5 1euR ®© Skrill 


Æ] Skrill PAPI) u © 


Card number 


Expiry date Security code 
MM YY CVV 

Cardholder name 

Type the name exactly as it appears on the card 


This payment will be processed as a Skrill Guest payment and 





is subject to the Skrill Privacy Policy. 


PAY NOW 








Cancel 
Powered by 
Ot= Skrill 


Figure 5-2: Enter Payment Details in the Skrill Payment Form 
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3. Click Pay Now to complete the payment. If all is correct, the payment form will display the 
following screen: 


01. Summary 02. Sign in 03. Address 04. Shipping 05. Payment 





® English United Kingdom 


16.51 EvR ® Skrill 


Vf 





Successful payment 


C= Skrill 


Figure 5-3: Successful Payment 


4. Click Continue to return to the Prestashop Order Confirmation screen. This screen contains 
the unique order number for this payment 


ORDER CONFIRMATION 


01. Summary 02. Sign in 03. Address 04. Shipping 05. Payment 





Your order on Skril Demo Shop is complete. Your order has been received 

Thank you for your purchase! 

Your order reference is : FLVHYSYBU 

You will receive an order confirmation email with details of your order and a link to track its progress 
Click here to print a copy of your order confirmation 


Figure 5-4: Order Confirmation in Prestashop Checkout 
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Removing or reducing the header and reducing the footer 

You can request a version of the Skrill payment form without the Skrill header and amount fields. The 
security logo is also removed from the footer, to reduce its size. To enable this option, please contact 
Skrill Merchant Services and ask for the Reduced Header and Footer option. This option is shown in 
the screenshot below (The standard payment form is shown on the left and the reduced header and 
footer option on the right). 


© English France 
10.0Q«vr 
O Engish France S English France 
© 

— Pacae 

-39 =» = 
rr © ii jo ($ 
visa SD 
VISA 
© wusa @9 

Expiry date Security code Expiry date Security code 

MM YY CVV Py ‘St any — Expiry date Security code 

MM YY CVV 

Cardholder name Cardholder name 

First Last First Last Cardholder name 

Firs? Last 
Email address Why ? Email address Why? 
Email address Why? 
PAY NOW PAY NOW 
PAY NOW 
Powered by Powered by 
Káta Norton s 
Skrill KÁ Skrill Powered by Skrill 


Figure 5-5: Reduced Header and Footer Option 


17 


Skrill Prestashop Module Configuration Guide 1.0 


6. Payment Information 


The Prestashop module provides payment information in the Order screen with information about the 
payment method used for an order. 


ES PAYMENT INFORMATION BY SKRILL 


Skrill Credit Card / Visa, Mastercard, AMEX, JCB, Diners 


Payment status Processed 

Used payment method MasterCard 
Order originated from United Kingdom 
Country (of the card-issuer) Sweden 

Order was placed using EUR 


Figure 6-1: Payment Information Example 
The Payment Information section includes the following information shown in order: 


The payment option selected in the Prestashop Checkout 


The payment status. See Table 6-1 for a list of payment status values. 

The payment option selected in the Skrill payment form. 

The country the payment order originated from. This information is obtained by Geolocation 

using the Customer’s IP address. 

5. The country of origin of the payment instrument used (this is only shown for card payment 
methods and bank accounts). For bank accounts, this shows the country where the account is 
registered. For cards, this shows the country where the card was issued. 

6. The currency the order was placed in using a 3-digit ISO 4217 currency code e.g. EUR for 

Euros. 


a an on a 


Table 6-1: Payment Status Values 


‘saws | peserpton 


Processed Payment has been processed 
and reached your merchant 
account 


Pending Payment is waiting to be 
executed 


Failed Payment failed. A payment 
failure reason is displayed. 

Chargeback The customer has requested a 
chargeback for this order 
through the acquirer. 
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Abandoned by user | This status is returned if the 
customer decides to close the 


browser once the Skrill 
Payment form loads. 





Update Order 

The Payment Information section also contains an Update Order button. This button is used to check 
an order’s payment status with the Skrill Payment Platform and re-send a status update. The payment 
information is then updated. This feature is useful if your Prestashop server goes offline or if there is a 
technical fault with Skrill’s servers which prevents payment status updates being sent or received. 


Refunding Payments 
The process for Refunding customer payments is as follows: 
1. Goto Orders in the Prestashop Admin Panel 


2. Search for the customer’s invoice using the customer’s order number orname 


Orders © i o 
|F E Œ Š 
14 
=| a 

EuD Paprem eccepoed 5 EY 

F: 7 Eriurajnj B Dh vee 
CEL i F B vu 
cap eee 5 li 
[Payment acempted 5 y 


Figure 6-2: Search for Order 


3. Click the correct Order to view more information 
4. Check that the details are correct 
5. Select Refund from the menu 


FORDER UVXBIWMKO #29 


© Print order Bh View invoice No delivery s = Partial refund 


2 


QOSTATUS 1 B DOCUMENTS 1 





Payment accepted = UPDATE STATUS 


Figure 6-3: Refund Payment 
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Order TEKGFIKDL from Test yest iii G 


Recommended Modules and Services Hel 


| © The payment has been successfully refunded. 


E Date Total 


04/10/2020 


E ORDER TEKGFIKDL #10 


&Printorder | View invoice RAVE ETSSEN] 


OSTATUS 2 B pocumenTs 1 


Refunded 04/10/2020 13:34:37 





SA Payment accepted 04/10/2020 13:23:31 


ESA Messages 
0 


r=] Products 
1 


« » & CUSTOMER | MRS. TEST YEST #5 


View full details... 


Email 
Mitest@gmail.com 
@ PRIVATE NOTE 


Account registered 
aula - Ario vii 4 6:24 


Valid orders placed 


Total spent since registration 


Resend email 


Resend email 


Figure 6-4: Refunded Payment 


fia 
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7. Testing 


We provide test cards shown in the table below for use with test merchant accounts. When using these 
card numbers enter an expiry date in the future and a random CVV number. 


Table 7-1: Test Cards 


5438311234567890 
4000001234567890 


Should you wish to test Skrill in DEMO shops please get in touch with Skrill support at 
newbusiness@ paysafe.com, so we can provide you with access. 





21 


